home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 July: Mac OS SDK / Dev.CD Jul 99 SDK1.toast / Development Kits / Mac OS / QuickTime / QuickTime 3 Interfaces & Libs / QTDevWin / CIncludes / ASDebugging.h < prev    next >
Encoding:
C/C++ Source or Header  |  1998-08-21  |  6.8 KB  |  224 lines  |  [TEXT/dosa]
  1. /*
  2.      File:        ASDebugging.h
  3.  
  4.      Contains:    AppleScript Debugging Interfaces.
  5.  
  6.      Version:    Technology:    AppleScript 1.1
  7.                  Release:    QuickTime 3.0
  8.  
  9.      Copyright:    © 1992-1998 by Apple Computer, Inc., all rights reserved
  10.  
  11.      Bugs?:        Please include the the file and version information (from above) with
  12.                  the problem description.  Developers belonging to one of the Apple
  13.                  developer programs can submit bug reports to:
  14.  
  15.                      devsupport@apple.com
  16.  
  17. */
  18. #ifndef __ASDEBUGGING__
  19. #define __ASDEBUGGING__
  20.  
  21. #ifndef __MACTYPES__
  22. #include <MacTypes.h>
  23. #endif
  24. #ifndef __FILES__
  25. #include <Files.h>
  26. #endif
  27. #ifndef __COMPONENTS__
  28. #include <Components.h>
  29. #endif
  30. #ifndef __APPLEEVENTS__
  31. #include <AppleEvents.h>
  32. #endif
  33. #ifndef __APPLESCRIPT__
  34. #include <AppleScript.h>
  35. #endif
  36.  
  37.  
  38.  
  39. #if PRAGMA_ONCE
  40. #pragma once
  41. #endif
  42.  
  43. #ifdef __cplusplus
  44. extern "C" {
  45. #endif
  46.  
  47. #if PRAGMA_IMPORT
  48. #pragma import on
  49. #endif
  50.  
  51. #if PRAGMA_STRUCT_ALIGN
  52.     #pragma options align=mac68k
  53. #elif PRAGMA_STRUCT_PACKPUSH
  54.     #pragma pack(push, 2)
  55. #elif PRAGMA_STRUCT_PACK
  56.     #pragma pack(2)
  57. #endif
  58.  
  59. /**************************************************************************
  60.     Mode Flags
  61. **************************************************************************/
  62. /*     This mode flag can be passed to OSASetProperty or OSASetHandler
  63.     and will prevent properties or handlers from being defined in a context
  64.     that doesn't already have bindings for them. An error is returned if
  65.     a current binding doesn't already exist. 
  66. */
  67.  
  68. enum {
  69.     kOSAModeDontDefine            = 0x0001
  70. };
  71.  
  72. /**************************************************************************
  73.     Component Selectors
  74. **************************************************************************/
  75.  
  76. enum {
  77.     kASSelectSetPropertyObsolete = 0x1101,
  78.     kASSelectGetPropertyObsolete = 0x1101,
  79.     kASSelectSetHandlerObsolete    = 0x1103,
  80.     kASSelectGetHandlerObsolete    = 0x1104,
  81.     kASSelectGetAppTerminologyObsolete = 0x1105,
  82.     kASSelectSetProperty        = 0x1106,
  83.     kASSelectGetProperty        = 0x1107,
  84.     kASSelectSetHandler            = 0x1108,
  85.     kASSelectGetHandler            = 0x1109,
  86.     kASSelectGetAppTerminology    = 0x110A,
  87.     kASSelectGetSysTerminology    = 0x110B,
  88.     kASSelectGetPropertyNames    = 0x110C,
  89.     kASSelectGetHandlerNames    = 0x110D
  90. };
  91.  
  92. /**************************************************************************
  93.     Context Accessors
  94. **************************************************************************/
  95. EXTERN_API( OSAError )
  96. OSASetProperty                    (ComponentInstance         scriptingComponent,
  97.                                  long                     modeFlags,
  98.                                  OSAID                     contextID,
  99.                                  const AEDesc *            variableName,
  100.                                  OSAID                     scriptValueID)                        FIVEWORDINLINE(0x2F3C, 0x0010, 0x1106, 0x7000, 0xA82A);
  101.  
  102. EXTERN_API( OSAError )
  103. OSAGetProperty                    (ComponentInstance         scriptingComponent,
  104.                                  long                     modeFlags,
  105.                                  OSAID                     contextID,
  106.                                  const AEDesc *            variableName,
  107.                                  OSAID *                resultingScriptValueID)                FIVEWORDINLINE(0x2F3C, 0x0010, 0x1107, 0x7000, 0xA82A);
  108.  
  109. EXTERN_API( OSAError )
  110. OSAGetPropertyNames                (ComponentInstance         scriptingComponent,
  111.                                  long                     modeFlags,
  112.                                  OSAID                     contextID,
  113.                                  AEDescList *            resultingPropertyNames)                FIVEWORDINLINE(0x2F3C, 0x000C, 0x110C, 0x7000, 0xA82A);
  114.  
  115. EXTERN_API( OSAError )
  116. OSASetHandler                    (ComponentInstance         scriptingComponent,
  117.                                  long                     modeFlags,
  118.                                  OSAID                     contextID,
  119.                                  const AEDesc *            handlerName,
  120.                                  OSAID                     compiledScriptID)                    FIVEWORDINLINE(0x2F3C, 0x0010, 0x1108, 0x7000, 0xA82A);
  121.  
  122. EXTERN_API( OSAError )
  123. OSAGetHandler                    (ComponentInstance         scriptingComponent,
  124.                                  long                     modeFlags,
  125.                                  OSAID                     contextID,
  126.                                  const AEDesc *            handlerName,
  127.                                  OSAID *                resultingCompiledScriptID)            FIVEWORDINLINE(0x2F3C, 0x0010, 0x1109, 0x7000, 0xA82A);
  128.  
  129. EXTERN_API( OSAError )
  130. OSAGetHandlerNames                (ComponentInstance         scriptingComponent,
  131.                                  long                     modeFlags,
  132.                                  OSAID                     contextID,
  133.                                  AEDescList *            resultingHandlerNames)                FIVEWORDINLINE(0x2F3C, 0x000C, 0x110D, 0x7000, 0xA82A);
  134.  
  135. EXTERN_API( OSAError )
  136. OSAGetAppTerminology            (ComponentInstance         scriptingComponent,
  137.                                  long                     modeFlags,
  138.                                  FSSpec *                fileSpec,
  139.                                  short                     terminologyID,
  140.                                  Boolean *                didLaunch,
  141.                                  AEDesc *                terminologyList)                    FIVEWORDINLINE(0x2F3C, 0x0012, 0x110A, 0x7000, 0xA82A);
  142.  
  143. /* Errors:
  144.        errOSASystemError        operation failed
  145.     */
  146. EXTERN_API( OSAError )
  147. OSAGetSysTerminology            (ComponentInstance         scriptingComponent,
  148.                                  long                     modeFlags,
  149.                                  short                     terminologyID,
  150.                                  AEDesc *                terminologyList)                    FIVEWORDINLINE(0x2F3C, 0x000A, 0x110B, 0x7000, 0xA82A);
  151.  
  152. /* Errors:
  153.        errOSASystemError        operation failed
  154.     */
  155. /* Notes on terminology ID
  156.  
  157.     A terminology ID is derived from script code and language code
  158.     as follows;
  159.  
  160.         terminologyID = ((scriptCode & 0x7F) << 8) | (langCode & 0xFF)
  161. */
  162.  
  163. /**************************************************************************
  164.     Obsolete versions provided for backward compatibility:
  165. */
  166. EXTERN_API( OSAError )
  167. ASSetProperty                    (ComponentInstance         scriptingComponent,
  168.                                  OSAID                     contextID,
  169.                                  const AEDesc *            variableName,
  170.                                  OSAID                     scriptValueID)                        FIVEWORDINLINE(0x2F3C, 0x000C, 0x1101, 0x7000, 0xA82A);
  171.  
  172. EXTERN_API( OSAError )
  173. ASGetProperty                    (ComponentInstance         scriptingComponent,
  174.                                  OSAID                     contextID,
  175.                                  const AEDesc *            variableName,
  176.                                  OSAID *                resultingScriptValueID)                FIVEWORDINLINE(0x2F3C, 0x000C, 0x1102, 0x7000, 0xA82A);
  177.  
  178. EXTERN_API( OSAError )
  179. ASSetHandler                    (ComponentInstance         scriptingComponent,
  180.                                  OSAID                     contextID,
  181.                                  const AEDesc *            handlerName,
  182.                                  OSAID                     compiledScriptID)                    FIVEWORDINLINE(0x2F3C, 0x000C, 0x1103, 0x7000, 0xA82A);
  183.  
  184. EXTERN_API( OSAError )
  185. ASGetHandler                    (ComponentInstance         scriptingComponent,
  186.                                  OSAID                     contextID,
  187.                                  const AEDesc *            handlerName,
  188.                                  OSAID *                resultingCompiledScriptID)            FIVEWORDINLINE(0x2F3C, 0x000C, 0x1104, 0x7000, 0xA82A);
  189.  
  190. EXTERN_API( OSAError )
  191. ASGetAppTerminology                (ComponentInstance         scriptingComponent,
  192.                                  FSSpec *                fileSpec,
  193.                                  short                     terminologID,
  194.                                  Boolean *                didLaunch,
  195.                                  AEDesc *                terminologyList)                    FIVEWORDINLINE(0x2F3C, 0x000E, 0x1105, 0x7000, 0xA82A);
  196.  
  197. /* Errors:
  198.         errOSASystemError        operation failed
  199.     */
  200. /**************************************************************************/
  201.  
  202.  
  203.  
  204. #if PRAGMA_STRUCT_ALIGN
  205.     #pragma options align=reset
  206. #elif PRAGMA_STRUCT_PACKPUSH
  207.     #pragma pack(pop)
  208. #elif PRAGMA_STRUCT_PACK
  209.     #pragma pack()
  210. #endif
  211.  
  212. #ifdef PRAGMA_IMPORT_OFF
  213. #pragma import off
  214. #elif PRAGMA_IMPORT
  215. #pragma import reset
  216. #endif
  217.  
  218. #ifdef __cplusplus
  219. }
  220. #endif
  221.  
  222. #endif /* __ASDEBUGGING__ */
  223.  
  224.